home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / tools / flist.com / FLIST.DOC < prev    next >
Encoding:
Text File  |  1989-01-10  |  3.6 KB  |  133 lines
  1.  
  2.                             ***** FLIST v1.0 *****
  3.  
  4.                                      FLIST v1.0
  5.                                          by
  6.                                  Frederick F. Portz
  7.                                    Copyright 1988
  8.  
  9.          INTRODUCTION
  10.          ------------
  11.  
  12.          FLIST stands for "formatted lister".  The purpose of the program
  13.          is to neatly format and list source code listings.  I use it to
  14.          list QuickBASIC programs, however it will work with any ASCII
  15.          file.  It creates the listing as follows:
  16.  
  17.          1.  It puts a header at the top of each page with the filename,
  18.              date, time, and page number.
  19.  
  20.          2.  It puts a footer at the bottom of each page.
  21.  
  22.          3.  It indents each line on the left to make the list easier to
  23.              bind.
  24.  
  25.          4.  It performs an "intelligent word wrap" at the right side of
  26.              each page.  The program will only break a line at a space.
  27.              This is very convenient for QuickBASIC programs because the
  28.              QuickBASIC editor automatically inserts spaces between
  29.              commands.  The remaining characters continue on the following
  30.              line, with the line marked with ">>".
  31.  
  32.          5.  The program can output to either a printer or a disk file.
  33.  
  34.          RUNNING FLIST
  35.          -------------
  36.  
  37.          To invoke FLIST type "FLIST disk:path\filename".  The file you
  38.          want to print MUST BE IN ASCII format.  Remember if you are using
  39.          QuickBASIC to save the file in ASCII format.
  40.  
  41.          If no filename is provided, the program will prompt for a
  42.          filename.  If it can't find the filename, the program asks if you
  43.          want to try another filename, or exit the program.
  44.  
  45.          The program then asks whether you want to print to the printer (P)
  46.          or disk (D).  I included the option to print to the disk mainly
  47.          for my development purposes - it allowed me to test the program
  48.          without wasting paper.
  49.  
  50.          If you select P for printer output, and the printer is not ready,
  51.          you will be prompted to fix the printer and then press the space
  52.          bar to try again, or hit the escape key to abort the program.
  53.          Once the program starts printing, you can abort the program by
  54.          pressing the escape key.
  55.  
  56.          If you select D for disk, you will be prompted for a filename.  DO
  57.          NOT USE THE SAME FILENAME (the program does not check).  Once you
  58.          input a filename, you will be prompted to press the space bar to
  59.          start printing to the file.  Once again, you can abort the program
  60.          at any time during the printing by pressing the escape key.
  61.  
  62.  
  63.  
  64.  
  65.                                    Page -1-   
  66.  
  67.  
  68.                             ***** FLIST v1.0 *****
  69.  
  70.  
  71.          FINAL NOTES
  72.          -----------
  73.  
  74.          FLIST is copyrighted 1988 by Frederick F. Portz.  The program is
  75.          placed in the public domain.  It may not be used for commercial
  76.          purposes.
  77.  
  78.          The program was written in Microsoft QuickBASIC 4.0.
  79.  
  80.          Please address any comments to:
  81.  
  82.                                  Frederick F. Portz
  83.                                  201 National Drive
  84.                                Pittsburgh, Pa.  15236
  85.  
  86.                               Compuserve ID:  75505,276
  87.  
  88.          QuickBASIC is a registered trademark of Microsoft corporation.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                    Page -2-   
  132.